JBoss Community Archive (Read Only)

RHQ 4.5

JBossAS - JMQ JMS Queue Service

Overview

Internal Name:

JMQ JMS Queue

Description:

 

Singleton:

no

Plugin:

JBossAS

Connection Settings

Name

Description

Required

Internal Name

Object Name

 

yes

objectName

Name Template

 

yes

nameTemplate

Description Template

 

yes

descriptionTemplate

Name

The name of this queue

yes

name

You must use the internal name to reference properties in Dynamic Group Definition expressions.

Metrics

Name

Type

Description

Internal Name

Messages in Queue

measurement

The number of undelivered messages in the queue.

QueueDepth

Receivers Count

measurement

The number of ClientConsumers waiting for a message.

ReceiversCount

Scheduled Message Count

measurement

The number of messages waiting to be scheduled

ScheduledMessageCount

In Process Message Count

measurement

The number of messages received by clients but not acknowledged (from AS 4.0.5)

InProcessMessageCount

You must use the internal name to reference traits in Dynamic Group Definition expressions.

Configuration Properties

Name

Description

Required

Internal Name

Destination Manager

The JMX object name of the destination manager configured for the server.

yes

DestinationManager

Security Manager

The JMX object name of the security manager that is being used to validate client requests.

no

SecurityManager

Expiry Destination

By default, JBossMQ silently removes expired JMS message from its destination. As of JBoss 4.0.4, expired messages can now be moved into a separate destination. ExpiryDestination indicates the javax.management.ObjectName of the expiry destination. This destination must be located on the same server and be a JBossMQ destination.

no

ExpiryDestination

JNDI Name

The location in JNDI to which the queue object will be bound. If this is not set it will be bound under the queue context using the name of the queue. This property is optional, in most cases the mbean name is used for binding purpose. See {server-config}/deploy/jms/jbossmq-destinations-service.xml for examples.

no

JNDIName

In Memory

Don't persist messages and avoid message softening when using the NullPersistenceManager

no

InMemory

Redelivery Limit

The maximum times a message is nacked before a message is sent to the Dead Letter Queue (0 - don't redeliver, n - redeliver n times, -1 - continue redelivering indefinitely)

no

RedeliveryLimit

Redelivery Delay

The length of time in milliseconds to wait before a message is redelivered after a nack

no

RedeliveryDelay

Message Counter History Day Limit

Sets the destination message counter history day limit with a value less than 0 indicating unlimited history, a 0 value disabling history and a value greater than 0 giving the history days count.

no

MessageCounterHistoryDayLimit

Maximum Depth

The MaxDepth is an upper limit to the backlog of messages that can exist for a destination. If exceeded, attempts to add new messages will result in a org.jboss.mq.DestinationFullException. The MaxDepth can still be exceeded in a number of situations, e.g. when a message is placed back into the queue. Also transactions performing read committed processing, look at the current size of queue, ignoring any messages that may be added as a result of the current transaction or other transactions. This is because we don't want the transaction to fail during the commit phase when the message is physically added to the queue.

no

MaxDepth

Recovery Retries

Specifies the number of times uncommitted transactions are to be resolved before failing. Default 0 - zero (from JBoss-4.0.3).

no

RecoveryRetries

Security Configurations

This element specifies a XML fragment which describes the access control list to be used by the SecurityManager to authorize client operations against the destination. The content model is the same as for the SecurityManager SecurityConf attribute.

yes

SecurityConf

Queue Name

Name of the queue to be used in the JMX object name.

yes

MBeanName

JNDI Binding

Binding path of this Queue in JNDI.

yes

JNDIBinding

You must use the internal name to reference properties in Dynamic Group Definition expressions.

Operations

Name

Description

Remove All Messages

Clears all Messages in the Queue

Reset Message Counter

Clears the MessageCounter data for this Queue

Reset Message Counter History

Clears the MessageCounter history data for this Queue

List Messages by Selector

Lists the Messages in the Queue by Selector (if provided). Selector is not required.

List Scheduled Messages

Lists the Scheduled Messages by Selector (if provided). Selector is not required.

List In Process Messages

Lists the Messages in process by Selector (if provided). Selector is not required.

JBoss.org Content Archive (Read Only), exported from JBoss Community Documentation Editor at 2020-03-12 12:59:10 UTC, last content change 2012-05-09 12:35:13 UTC.